home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / WINDOWS / CANVAS11.ARJ / CANVAS.TXT < prev    next >
Text File  |  1992-09-01  |  24KB  |  694 lines
  1.  
  2.                                    SongCanvas
  3.                                   User's Manual
  4.                                 Table of Contents
  5.  
  6.  
  7.  
  8.  
  9.  
  10. Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  11.  
  12. Overview  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  13.  
  14. Quick Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  15.  
  16. General Instructions  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  17.  
  18. Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  19.  
  20. Editing Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  21.  
  22. MIDI Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  23.  
  24. Appendix A  Installation ─ Detailed Instructions  . . . . . . . . . . . . . .  8
  25. Appendix B  Command-Line Parameters . . . . . . . . . . . . . . . . . . . . .  9
  26. Appendix C  Terminating Errors  . . . . . . . . . . . . . . . . . . . . . . . 10
  27. Appendix D  MIDI Information  . . . . . . . . . . . . . . . . . . . . . . . . 10
  28. Appendix E  MIDI Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. ________________________________________________________________________________
  63.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  64.                Copyright 1992 by Jeff Cazel ─ All Rights Reserved              1
  65.                                     OVERVIEW
  66.  
  67. The SongCanvas is a  complete IBM-compatible patch editor and  librarian program
  68. for  Roland's  GS synthesizers  (SOUNDCanvas  SC-55, SC-155,  SCC-1,  LM-300 and
  69. JV-30).   It supports all popular  MIDI interfaces and works  equally well under
  70. DOS, Windows 3.1 and DESQview.
  71.  
  72. The SongCanvas plays your MIDI files as you edit─you hear your changes instantly
  73. in  the context  of your own  musical projects!   It saves its  data in standard
  74. binary  format (also  called "MIDIEX  format")  so it  is  compatible with  bulk
  75. loaders and  other utilities.  Finally,  it gives you complete  control over all
  76. parameters.
  77.  
  78. To  maximize data  integrity,  the  SongCanvas  is  designed  for  one-way  MIDI
  79. communication only (from the computer  to the SOUNDCanvas).  Data can't  be lost
  80. when  other windows  transmit  extraneous  data  and/or switch  the  interface's
  81. operating mode.
  82.  
  83. A GS sound  module or  keyboard is  referred to  as a  "Canvas" throughout  this
  84. manual.   "GS" is Roland's  General Standard─a superset  of the nascent  General
  85. MIDI standard.  If you  have an SCC-1, please ignore references to the "display"
  86. or  "LCD"─it doesn't  have  one.   Note  also that  the  SCC-1  is hardwired  as
  87. device #17.
  88.  
  89. This manual describes how  to modify, save  and audition the various  parameters
  90. within the Canvas.  It does not describe what these parameters do.  For example,
  91. it describes how to turn Parts On and Off, but it doesn't state what effect that
  92. has on the sound nor why you may want that effect.  The online help and  various
  93. Canvas owner's manuals do explain some of these parameters, however.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125. ________________________________________________________________________________
  126.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  127.                   Contact me via CompuServe Mail ─ #72461,3345                 2
  128.                                QUICK INSTALLATION
  129.  
  130.  
  131. 1─Connect  a MIDI  cable from the  computer's MIDI  Out to the  Canvas's MIDI In
  132. (pre-wired on the SCC-1).
  133.  
  134.  
  135. 2─Copy  and/or  PKUNZIP all  files  into  a new  directory  and  change to  that
  136. directory.
  137.  
  138.  
  139. 3─If you have an MPU401 or compatible interface using IRQ 2 and address 330h, go
  140. to  step #5 (if  you don't  know which  type you  have, you  can probably  go to
  141. step #5  as well).   Otherwise, run CANVAS  /?  for details on  configuring your
  142. MIDI  interface with the  DOS SET  command.  (The  SCC-1's MIDI  interface is an
  143. MPU401.)
  144.  
  145.  
  146. 4─Type the SET command as determined in step #3 and press <Enter>; for example:
  147.  
  148.                               SET OPT1=-dmpu:5:336
  149.  
  150.   (Now is also a good time to add this command to your AUTOEXEC.BAT file.   Note
  151.   the "-" between the "=" and the "d".)
  152.  
  153.  
  154. 5─Enter one of these four commands and press <Enter>:
  155.  
  156.   C                 runs as device #17 (Canvas default).
  157.  
  158.   C  /D:18          runs  on device #18 (change "18"  to any device #  from 1 to
  159.                     32).
  160.  
  161.   CANVAS  /D:0      runs with MIDI disabled─"demo"  mode for computers without a
  162.                     MIDI interface.
  163.  
  164.   CANVAS  /?        displays  help screens  explaining  all of  the SongCanvas's
  165.                     command-line options.
  166.  
  167.  
  168.  
  169. See Appendix A for details on segregating data and program files, etc.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188. ________________________________________________________________________________
  189.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  190.                Copyright 1992 by Jeff Cazel ─ All Rights Reserved              3
  191.                               GENERAL INSTRUCTIONS
  192.  
  193. You perform all SongCanvas functions  from menus.  You can move  the highlighted
  194. cursor bar to the desired choice using the keyboard (arrow  keys, <Home>, <End>,
  195. <PgUp> and <PgDn>);  you then press <Enter>  to select it.   If you have  loaded
  196. your mouse driver (recommended), you can also point your mouse cursor at an item
  197. and left click to select it.
  198.  
  199. Note the scroll arrows within the right border of scrollable menus (e.g., Master
  200. Pan).  You may cursor as needed  or position the mouse cursor on the appropriate
  201. scroll bar and hold down the left button.  For fastest  scrolling, you can click
  202. and drag the right border's scroll button with the mouse.
  203.  
  204. Throughout  the program,  clicking and  releasing the  right mouse  emulates the
  205. <Escape> key.   Left-handed users can  swap the mouse buttons  for all functions
  206. with the /L command-line option.
  207.  
  208. Press <Escape> to back out one menu level.  Pressing <Escape> from the MAIN MENU
  209. quits the program after confirming  your request.  However, if you  try to quit,
  210. reFRESH your data or LOAD a new patch file before saving your current patch, the
  211. program will tell you  so and ask if you're  sure you want to continue.   Select
  212. Yes to  continue the operation.   Select  No (or press  <Escape>) to cancel  the
  213. operation and position the cursor bar on SAVE.
  214.  
  215. The  SongCanvas  will  not accept  invalid  data  (e.g.,  periods in  filenames,
  216. hieroglyphic  patch names)  nor data  past  the end  of the  field (e.g.,  nine-
  217. character filenames).  During any edit, you may backspace to change data─nothing
  218. becomes "permanent"  until you press <Enter>.   You may always  change your mind
  219. before then by pressing <Escape> to revert to the prior value.
  220.  
  221. The SongCanvas displays the current patch filename in the upper  left corner and
  222. the patch name in the upper right corner of the screen.
  223.  
  224. The SongCanvas accesses patch  files in the current directory only  (though this
  225. can be different from where the program is stored).   This design simplifies the
  226. user  interface and  minimizes  set-up  headaches.    See  Appendix A  for  more
  227. information.
  228.  
  229. Whenever the SongCanvas transmits  system exclusive data, SysEx displays  in the
  230. lower center  of  the screen.   This  data transmits  on the  MIDI device #  you
  231. specify on the command-line.  This transmission temporarily pauses the MIDI file
  232. player (when playing)  so system  exclusive and channel  messages don't  collide
  233. with each other.
  234.  
  235. Help is available at any time by  pressing <F1>.  Within Help, press <Alt><I> to
  236. display the Help Index.   <Tab> to How To Use Online Help and  press <Enter> for
  237. full instructions.
  238.  
  239. Registered users  can also get Help by clicking on the <F1>-Help "button" on the
  240. bottom  left of the screen.   See the  MIDI Menu section for  other keyboard and
  241. mouse shortcuts.
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251. ________________________________________________________________________________
  252.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  253.                   Contact me via CompuServe Mail ─ #72461,3345                 4
  254.                                     MAIN MENU
  255.  
  256. The MAIN MENU has six options ─ EDIT, LOAD, FRESH, RENAME, SAVE, and CLIP.
  257.  
  258. EDIT displays a list of the Canvas's parameter groups and asks you to select one
  259. for editing.  See EDITING PATCHES for more information.
  260.  
  261. LOAD pops-up a  list of data files in your current  directory.  Selecting a file
  262. sends its  data to the  Canvas.  Press <Escape>  to exit without  loading a data
  263. file.
  264.  
  265. FRESH resets all patch  data and the Canvas to the factory defaults.  You may do
  266. this in  lieu of LOADing a data file.   The file name becomes UNTITLED.SCD which
  267. you'll probably want to SAVE AS a new name when you're ready.
  268.  
  269. RENAME redisplays  the current  patch name  and allows  you to  rename it.   All
  270. displayable  ASCII characters  are valid.   A patch  name can  be up  to sixteen
  271. characters long.  Type in the new name and press <Enter>.  This displays the new
  272. name  on the  Canvas's display.   Press  <Escape> to  exit without  renaming the
  273. patch.
  274.  
  275. SAVE pops-up a dialog box  with three options:  SAVE, to save the  file with its
  276. current filename; SAVE AS, to save  the file with a new filename; or  CANCEL, to
  277. change your mind.  For SAVE AS, type  in the new data filename and press <Enter>
  278. (don't type the .SCD file extension (the SongCanvas will prevent  you from doing
  279. so)).  Press <Escape> to exit without saving the file.
  280.  
  281. CLIP  copies the  patch  data  to the  Windows 3.1  clipboard  for pasting  into
  282. sequencers.  This option is not yet available.
  283.  
  284.  
  285.                   *   *   *   *   *   *   *   *   *   *   *   *
  286.  
  287.  
  288. Registered  versions of  the  program will  automatically  save the  non-default
  289. ('changed') data  as a small "MIDIEX"  file with a .CHG file  extension when you
  290. SAVE the .SCD file.  You can use these  to "prime" your Canvas with various set-
  291. ups.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314. ________________________________________________________________________________
  315.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  316.                Copyright 1992 by Jeff Cazel ─ All Rights Reserved              5
  317.                                  EDITING PATCHES
  318.  
  319. The MAIN EDIT MENU  lists several parameter  groups which correspond roughly  to
  320. the Canvas's internal data layout.  Select a parameter group to display its edit
  321. screen.
  322.  
  323. Within  the individual edit screens, the parameter prompts generally mimic those
  324. found on the Canvas's LCD.   The edit interface is very straightforward once you
  325. understand  the three types of data and respective procedures (please experiment
  326. here):
  327.  
  328.     (1) two-value  toggles (e.g., Receive Note On/Off) ─ Select toggles back and
  329.         forth between the two available values.
  330.  
  331.     (2) pop-ups ─ these are parameters whose values are either:
  332.  
  333.         (a) non-ordinal  numbers  (e.g.,  Reverb Macro 5  does  not  reverberate
  334.             "more" than Macro 4), or
  335.  
  336.         (b) not described by numbers (e.g., Part 1 plays a Mandolin instead of a
  337.             Banjo).
  338.  
  339.         Select pops-up a  list of the valid values.  If you don't want to change
  340.         the  value, press <Escape>.   Non-ordinal parameters have  an attempt at
  341.         "describing" the qualitative aspect  so you don't have to  reference the
  342.         Canvas's manual.  For example, Reverb Macro 4 is described as Hall 2 per
  343.         the SCC-1 manual.
  344.  
  345.     (3) quantitative  numbers  (e.g.,  Master  Volume) ─ these  values  do  have
  346.         ordinal relationships (e.g., a Master Volume value of 127 is louder than
  347.         126).  Select  asks you for  a new value  within the valid  range (e.g.,
  348.         "Enter a new  value between  0 and 127").   Enter the  number and  press
  349.         <Enter>.  If  you don't want to change the value,  press <Escape>.  Note
  350.         that although several parameters are quantitative (e.g., MOD LF01  PITCH
  351.         DEPTH),  only certain  discrete values  are available.   Thus,  they are
  352.         edited like the pop-ups in (2) above.
  353.  
  354. Each valid change sends the new MIDI data immediately to the Canvas.
  355.  
  356.  
  357.                   *   *   *   *   *   *   *   *   *   *   *   *
  358.  
  359.  
  360. Within  the various  edit  screens, <Ctrl><PgUp>  and  <Ctrl><PgDn> will  scroll
  361. through  the  16  Parts.   I've  sequenced  these  Parts  per Roland's  priority
  362. assignments.   Thus,  the  "lowest" part  (highest  priority) is  Part #10;  the
  363. "highest" is #16.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377. ________________________________________________________________________________
  378.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  379.                   Contact me via CompuServe Mail ─ #72461,3345                 6
  380.                                     MIDI MENU
  381.  
  382. The MIDI MENU has five options ─ RESET, LOAD, PLAYER, REWIND, and THRU.  You can
  383. access  the MIDI Menu from other menus  by pressing <Alt-M> ("MIDI" will display
  384. on the bottom border when available).   Registered users can also click on  this
  385. "MIDI button" to pull up the menu.
  386.  
  387. RESET puts the MIDI interface back into the correct operating mode.  This option
  388. should  only be necessary in multi-program environments when another window sets
  389. the interface into a new mode.
  390.  
  391. LOAD pops-up the  list of song files (*.MID)  in the directory specified  by the
  392. command-line's /MID: parameter.  (If /MID: is not specified, it defaults to your
  393. current  directory.)  Select  a file to  start playing it in  a continuous loop.
  394. LOAD displays an  error message if there is a problem  loading the file; it then
  395. reloads, rewinds and replays the  prior file if one was loaded and if  it can do
  396. so.
  397.  
  398. PLAYER toggles the  MIDI file  player On and  Off─it starts a  stopped song  and
  399. stops a  playing song.   <Alt-P> will also  toggle the player  On and Off.   The
  400. elapsed time from the start  of the song displays  in the lower right corner  of
  401. the screen.  PLAYER is not available if a song is not loaded.
  402.  
  403. REWIND resets  the player to its  beginning and then restarts  the current song.
  404. REWIND is not available if a song is not loaded.
  405.  
  406. THRU toggles MIDI Thru  On and Off.  When Thru is On,  MIDI data received at the
  407. computer's  MIDI In is re-routed  to the MIDI Out whenever  the program is idle.
  408. <Alt-T> will also toggle Thru On and Off.
  409.  
  410.  
  411.  
  412. The words Thru and Play are highlighted or dimmed on the bottom of the screen to
  413. indicate their  On or Off states,  respectively.  Registered users  can click on
  414. these "buttons"  to toggle the functions;  they can also click  on the <F1>-Help
  415. and MIDI  buttons.  Finally, registered  users can toggle the player  On and Off
  416. with the <Space> bar.
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440. ________________________________________________________________________________
  441.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  442.                Copyright 1992 by Jeff Cazel ─ All Rights Reserved              7
  443.                                    Appendix A
  444.                       INSTALLATION ─ DETAILED INSTRUCTIONS
  445.  
  446. System  Requirements: Any  IBM-compatible  personal computer  with an  80-column
  447. monitor,  DOS  3.0 or  higher  and 450K  free RAM.    For system  exclusive MIDI
  448. communication, you'll  also need a supported  MIDI interface and (of  course!) a
  449. Canvas.  You can play MIDI files without a  Canvas, however.  Run CANVAS  /? for
  450. information on configuring your MIDI interface with the DOS SET command.
  451.  
  452. CANVAS.EXE is the main  program file, CANVAS.HLP contains the  help information,
  453. and CANVAS.REG contains your personal registration information.  All three files
  454. must  be in the  same directory.   (As implied, CANVAS.REG  is not necessary nor
  455. included in the unregistered version.)
  456.  
  457. PLAYD.EXE  is  the  MIDI  engine.    See  the  MIDI  ENGINE  appendix  for  more
  458. information.
  459.  
  460. Data files (*.SCD) can be in a separate directory (recommended).  The SongCanvas
  461. comes  with one  data file;  DEFAULT.SCD contains  the data  that exists  in the
  462. Canvas when reset.
  463.  
  464. To run the SongCanvas when the data and the program are in separate directories,
  465. type the following commands:
  466.  
  467.   D:                       go to the drive containing your patch data (given  as
  468.                            D: in this example)
  469.  
  470.   CD \SYSEX                go to the directory containing your patch data (given
  471.                            as \SYSEX in this example)
  472.  
  473.   C:\MTOOLS\PLAYD -a64     type the fully-qualified path  to PLAYD.EXE (given as
  474.                            C:\MTOOLS\PLAYD.EXE   in   this   example).       See
  475.                            POWERUSR.WRI for all  of the  MIDI engine's  command-
  476.                            line options.
  477.  
  478.   C:\SC\CANVAS /D:18       type the fully-qualified path to CANVAS.EXE (given as
  479.                            C:\SC\CANVAS.EXE in this example).  See the  COMMAND-
  480.                            LINE PARAMETERS appendix for  all of the SongCanvas's
  481.                            command-line options.
  482.  
  483.  
  484. Note:  You can put  these commands  in a  batch file (like  C.BAT) or  your menu
  485. system.  You can also customize the included CANVAS.PIF or  SC-PIF.DVP files for
  486. use in Windows 3.1 or DESQview 2.x, respectively.
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503. ________________________________________________________________________________
  504.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  505.                   Contact me via CompuServe Mail ─ #72461,3345                 8
  506.                                    Appendix B
  507.                              COMMAND-LINE PARAMETERS
  508.  
  509. The  SongCanvas has  several optional  command-line parameters  to  maximize its
  510. flexibility.   Note that parameters  (a) are not case-sensitive  (e.g., /d:17 is
  511. the same as  /D:17), (b) must be  separated by at least  one space (i.e.,  there
  512. must be a  space before each  "/" character), and  (c) may not contain  imbedded
  513. spaces (e.g., /D:   18 is invalid).
  514.  
  515.  
  516.                      CANVAS   /D:n   /MID:dir   /L   /M   /?
  517.  
  518. /D:n        Device # ─  use MIDI  device #"n".   /D:0 disables  MIDI  output and
  519.             overrides /MID:dir.
  520.  
  521. /MID:dir    MIDI files ─  load standard  MIDI  files from  the "dir"  directory.
  522.             Defaults  to the current directory if not specified.  The SongCanvas
  523.             handles pathnames like DOS  does─e.g., if you're in D:\MIDI  and the
  524.             song files are  in D:\MIDI\Jams,  each of these  three options  will
  525.             work: /M:Jams,  /M:\MIDI\Jams, or /M:D:.\Jams.   The SongCanvas will
  526.             play CANVAS.MID at startup if it exists in this directory.
  527.  
  528. /L          Left-handed mouse ─ swaps the left and right mouse buttons for left-
  529.             handed users.
  530.  
  531. /M          Monochrome ─  display black and white.   This option  is most useful
  532.             for portables and other computers whose "colors" don't contrast.
  533.  
  534. /?          Help ─ displays  DOS 5.0-style help.   This parameter  overrides all
  535.             others.
  536.  
  537.  
  538.                      Defaults:      CANVAS   /D:17   /MID:.\
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566. ________________________________________________________________________________
  567.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  568.                Copyright 1992 by Jeff Cazel ─ All Rights Reserved              9
  569.                                    Appendix C
  570.                                TERMINATING ERRORS
  571.  
  572. Five errors terminate the SongCanvas before it starts.  These  errors display an
  573. informative message on  the middle of the screen and  return the displayed error
  574. number  to  DOS  (see the  batch  file  section in  your  DOS  manual if  you're
  575. interested in  using  this information  with the  IF ERRORLEVEL  command).   The
  576. errors are easy to correct:
  577.  
  578.   1 ─ Command-line syntax  error ─ a  command-line "spelling"  error.   Embedded
  579.   spaces are  not allowed within  any parameter (e.g., /D:   17 is  invalid); at
  580.   least one space is required  between parameters (i.e., before each "/").   Run
  581.   CANVAS /? if you want command-line help.
  582.  
  583.   2 ─  Non-numeric device # requested ─  all characters after  the /D: parameter
  584.   must be numeric.
  585.  
  586.   3 ─ Illegal device # requested ─  the characters after the /D:  parameter must
  587.   indicate an integer between 1 and 32 (or 0 to disable MIDI output).
  588.  
  589.   4 ─ CANVAS.HLP  file not found ─ CANVAS.EXE  and CANVAS.HLP need to  be in the
  590.   same directory.
  591.  
  592.   5 ─  CANVAS.HLP  file  wrong  version ─  current  versions of  CANVAS.EXE  and
  593.   CANVAS.HLP need  to be in the same  directory.  Be sure  to install the latest
  594.   version of the software correctly.
  595.  
  596.  
  597. CANVAS.EXE will still run if  the MIDI engine doesn't correctly initialize,  but
  598. MIDI  will   be  disabled.    See   the  MIDI  ENGINE  appendix   for  MIDI  I/O
  599. troubleshooting information.
  600.  
  601.  
  602.  
  603.                                    Appendix D
  604.                                 MIDI INFORMATION
  605.  
  606. If your edits do not update the Canvas, it's probably because (1) another window
  607. within  your  multi-program  environment   has  changed  your  MIDI  interface's
  608. operating mode, (2) your SOUNDCanvas is set-up to ignore  sysex data, or (3) the
  609. device #s on the SongCanvas and your SOUNDCanvas don't match.   Don't worry─your
  610. data is safe.   To  correct (1), RESET  the interface  from the MIDI  MENU.   To
  611. correct (2), see the instructions in the SOUNDCanvas's owner's manual.  Finally,
  612. to correct (3), change the device #  on the Canvas (also in the owner's  manual)
  613. and/or specify the correct SongCanvas device # via the /D:n option.
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629. ________________________________________________________________________________
  630.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  631.                   Contact me via CompuServe Mail ─ #72461,3345                10
  632.                                    Appendix E
  633.                                    MIDI ENGINE
  634.  
  635. DOS versions of Jeff Cazel MIDI software now use FM Software's  PLAYD.EXE as the
  636. MIDI 'engine'.   PLAYD.EXE is actually a  separately executed program─CANVAS.EXE
  637. by itself no longer sends  sysex data nor plays MIDI files.  This modular set-up
  638. provides  greater device  independence and supports  more MIDI  interfaces using
  639. less memory.
  640.  
  641. PLAYD handles  CANVAS's requests to send  sysex data and to start  and stop song
  642. playback.  You load  PLAYD with the correct options for  your interface and then
  643. run CANVAS.  The two programs then work in tandem.
  644.  
  645. Run  CANVAS /?  to see  PLAYD's  configuration options.   Power  users who  seek
  646. complete details  on PLAYD can read  the POWERUSR.WRI file.   This Windows Write
  647. document  discusses  optimization  under  Windows  (including  the   multi-media
  648. extensions), DESQview and DOS.
  649.  
  650. Registered SongCanvas  users receive a certificate to  buy MidiTools for 25% off
  651. of  the regular  price.   See the  MTOOLS.TXT file  for complete  information on
  652. MidiTools.
  653.  
  654.  
  655. Notes
  656.  
  657.   The maximum path length for a PLAYD song file is 40 bytes.  Longer  file names
  658.   will return a "file  not found" error  message upon LOAD.   Use the DOS  SUBST
  659.   command if this becomes a problem.
  660.  
  661.   PLAYD handles MIDI files up to 16 tracks.  All tracks numbered greater than 16
  662.   are ignored during playback.
  663.  
  664.   PLAYD can handle MIDI files up to 64K in size.  Larger files will not load.
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692. ________________________________________________________________________________
  693.                  SongCanvas ─ GS Editor/Librarian ─ Version 1.1
  694.                Copyright 1992 by Jeff Cazel ─ All Rights Reserved             11